클로드 완벽가이드 (입문) — 0장 한눈에 보기

출처: 클로드 코드 완벽 가이드 (코드팩토리 최지호)

이 장에서 딱 2가지만: 첫째, 이 책에서 계속 나올 핵심 용어 27개를 '한 문장 뜻 + 일상비유 + 한 줄 예'로 미리 익힌다. 둘째, 1장부터 부록까지가 한 줄기로 어떻게 이어지는지 큰 그림을 본다.

이 장은 "사전 + 지도"다. 용어를 다 외울 필요는 없다. 뒤에서 모르는 말이 나오면 여기로 돌아와 찾으면 된다.

학습 목표 이 장을 마치면 이렇게 할 수 있다. 핵심 용어 27개를 일상 비유로 설명한다. 1장부터 부록까지의 흐름을 한 문장으로 설명한다. 모르는 용어가 나왔을 때 어디를 찾아야 하는지 구분한다.

1. 먼저, 막힌 적 있죠?

상상해 보자. 친구가 "터미널 열고 명령어 치면 돼"라고 했는데, 터미널이 뭔지 몰라서 멈춘 적. "CLAUDE.md에 적어두면 돼"라는데 그게 무슨 파일인지 몰라서 멈춘 적. "MCP 붙이면 깃허브랑 연결돼"라는데 MCP가 외계어처럼 들린 적.

이런 멈춤의 원인은 딱 하나다. 용어를 모르면 설명도 안 들린다. 그래서 이 책은 용어부터 깐다.

규칙 하나. 앞으로 어려운 말이 나오면, 그 말은 이 0장 용어집에 이미 풀어놨다고 생각하면 된다. 혹시 여기 없는 새 용어가 본문에 처음 나오면, 그 자리에서 '한 문장 뜻 + 일상비유' 한 줄로 바로 풀어줄 것이다. 용어로 용어를 설명하는 일은 없다.

2. 핵심 용어집 27개

각 용어는 세 줄로 푼다. 뜻 한 문장, 일상비유, 한 줄 예.

2-1. 터미널 (Terminal)

뜻: 컴퓨터에 글자로 명령을 내리는 검은 화면. 비유: 식당에서 말로 주문하는 카운터. 버튼이 아니라 말(명령어)로 시킨다. 예: 검은 창에 claude라고 치고 엔터 → 클로드 코드가 켜진다.

2-2. CLI (Command Line Interface)

뜻: 마우스 없이 글자 명령으로 프로그램을 다루는 방식. 비유: 리모컨 없이 음성으로만 켜는 TV. 말(명령)이 곧 조작이다. 예: cd 폴더이름 한 줄로 폴더를 옮긴다. 클릭이 없다.

2-3. 클로드 코드 (Claude Code)

뜻: 앤트로픽이 만든, 터미널 안에서 일하는 AI 개발 동료. 비유: 내 컴퓨터에 출근한 시니어 개발자. 코드를 읽고, 짜고, 테스트까지 한다. 예: "로그인 기능 만들어줘" 한 마디에 파일을 만들고 코드를 쓴다.

2-4. 슬래시 명령어 (Slash Command)

뜻: /로 시작하는, 클로드 코드 전용 특수 명령. 비유: 게임의 치트키. 정해진 짧은 명령으로 기능을 바로 부른다. 예: /init, /help, /model처럼 /를 누르면 목록이 뜬다.

2-5. CLAUDE.md

뜻: 클로드 코드에게 "이 프로젝트는 이런 곳이야"를 알려주는 메모 파일. 비유: 신입에게 주는 온보딩 문서. 규칙과 구조가 한 장에 적혀 있다. 예: "테스트는 꼭 pnpm test로 돌려"라고 적어두면 매번 안 알려줘도 된다.

2-6. MCP (Model Context Protocol)

뜻: AI가 깃허브, 데이터베이스 같은 바깥 도구와 연결되게 해주는 약속. 비유: 만능 통역사. AI를 외부 서비스와 말이 통하게 이어준다. 예: MCP를 붙이면 "깃허브 이슈 42번 보여줘"가 그냥 된다.

2-7. 모델 (Model)

뜻: 실제로 생각하고 답을 만드는 AI의 두뇌. 비유: 같은 자동차라도 엔진이 다르듯, 같은 도구라도 두뇌가 다를 수 있다. 예: 클로드 코드는 상황에 따라 더 똑똑한 두뇌나 더 빠른 두뇌를 고른다.

2-8. 토큰 (Token)

뜻: AI가 글자를 처리하는 최소 단위. 사용량과 비용의 기준. 비유: 택시 미터기의 거리 단위. 많이 갈수록(많이 쓸수록) 올라간다. 예: 긴 대화를 주고받을수록 토큰이 더 쓰인다.

2-9. 컨텍스트 / 컨텍스트 윈도우 (Context Window)

뜻: AI가 한 번에 기억하고 참고할 수 있는 정보의 최대 범위. 비유: 책상 크기. 책상이 넓으면 자료를 많이 펼쳐두고 보지만, 꽉 차면 오래된 걸 치워야 한다. 예: 대화가 길어지면 책상이 차서 앞 내용을 정리해야 한다.

2-10. 에이전트 / 에이전틱 AI (Agentic AI)

뜻: 시키는 한 단계만 하는 게 아니라, 스스로 계획하고 실행하는 AI. 비유: "이 일 해줘" 하면 알아서 처리하는 경력 동료. 하나하나 지시 안 해도 된다. 예: "결제 기능 추가해줘" → 분석하고, 계획 짜고, 코드 쓰고, 테스트까지.

2-11. 서브에이전트 (Subagent)

뜻: 메인 AI가 일부 작업을 떼어 맡기는 작은 보조 AI. 비유: 팀장이 일을 나눠주는 팀원들. 각자 맡은 부분을 따로 처리한다. 예: 번역은 1번, 테스트는 2번에게 동시에 시켜 빨리 끝낸다.

2-12. 프로젝트 루트 (Project Root)

뜻: 프로젝트의 가장 위 폴더. 클로드 코드는 여기서 켜야 한다. 비유: 건물의 1층 로비. 여기서 출발해야 모든 층(파일)에 갈 수 있다. 예: 하위 폴더에서 켜면 위쪽 설정 파일을 못 봐서 헤맨다.

2-13. 플래닝 모드 (Planning Mode)

뜻: 코드를 바로 안 짜고, 계획만 먼저 세우는 모드. 비유: 요리 전에 레시피부터 짜기. 재료 다 꺼내기 전에 순서를 정한다. 예: "바로 만들지 말고 계획부터 보여줘" → 설계도만 받아 검토.

2-14. PRD (제품 요구사항 정의서)

뜻: "무엇을, 왜 만드는가"를 적어두는 문서. 비유: 집 짓기 전 건축주의 요구서. 방 몇 개, 왜 필요한지를 먼저 적는다. 예: 문제, 대상 사용자, 해결책, 성공 기준을 정리한 한 장.

2-15. 실행 계획 (Execution Plan)

뜻: PRD를 "어떻게, 언제까지" 만들지 정하는 기술 문서. 비유: 건축 시공 일정표. 무엇을 먼저 짓고 언제 끝낼지를 적는다. 예: 작업을 잘게 쪼개고 순서와 일정을 정한 목록.

2-16. 배포 (Deploy)

뜻: 내가 만든 걸 사용자가 실제로 쓸 수 있게 인터넷에 올리는 것. 비유: 음식점 오픈. 주방에서만 만들던 음식을 손님에게 내놓는 순간. 예: 완성한 사이트를 올리면 누구나 주소로 접속할 수 있다.

2-17. Hooks (Claude Code Hooks)

뜻: 특정 순간에 내가 정한 동작을 자동으로 끼워 넣는 기능. 비유: 자동문 센서. "사람이 오면 문을 연다"처럼 조건이 맞으면 자동 실행. 예: "파일을 저장하면 자동으로 문법 검사를 돌려라"를 걸어둔다.

2-18. 깃 / 깃허브 (Git / GitHub)

뜻: 깃은 코드 변경을 기록하는 도구, 깃허브는 그 코드를 모아두는 온라인 창고. 비유: 깃은 글쓰기의 '저장 기록', 깃허브는 그 글을 올려두는 클라우드 폴더. 예: 깃으로 변경을 저장(커밋)하고, 깃허브에 올린다(푸시).

2-19. Git Worktree (워크트리)

뜻: 한 저장소에서 여러 작업 폴더를 따로 만들어 동시에 일하는 기능. 비유: 같은 책의 복사본 여러 권. 각자 다른 장을 동시에 편집해도 안 섞인다. 예: A 기능은 1번 폴더, B 기능은 2번 폴더에서 동시에 작업.

2-20. Super Claude

뜻: 클로드 코드에 전문 명령어 묶음을 더해주는 외부 프레임워크. 비유: 기본 휴대폰에 까는 전문가용 앱 묶음. 기능이 확 늘어난다. 예: /sc:로 시작하는 분석·구현 명령들을 추가로 쓴다.

2-21. Claudia

뜻: 터미널이 부담스러운 사람을 위해 클로드 코드에 화면(GUI)을 붙인 앱. 비유: 명령어 대신 버튼으로 쓰는 리모컨. 클릭으로 조작한다. 예: 자주 쓰는 작업을 저장해두고 버튼으로 다시 실행.

2-22. Claude Squad

뜻: 여러 클로드 코드 에이전트를 한 화면에서 동시에 관리하는 도구. 비유: 여러 일꾼을 한 칠판으로 관리하는 현장 반장. 예: 세션을 여러 개 만들어 각자 다른 일을 시키고 한눈에 본다.

2-23. ccusage

뜻: 클로드 코드의 토큰 사용량과 비용을 보여주는 외부 도구. 비유: 통신사 데이터 사용량 앱. 얼마나 썼는지 그래프로 보여준다. 예: 일별, 월별로 내가 토큰을 얼마나 썼는지 확인한다.

2-24. Claude Code Action

뜻: 깃허브 안에서 클로드 코드를 자동으로 돌리게 해주는 기능. 비유: 회사 메일에 자동 응답 설정. 조건이 맞으면 사람 없이도 처리. 예: PR이 올라오면 자동으로 코드 리뷰를 단다.

2-25. 프롬프트 (Prompt)

뜻: AI에게 시키는 말, 즉 입력하는 요청문. 비유: 후배에게 건네는 업무 지시. 구체적일수록 결과가 좋다. 예: "코드 짜줘"보다 "에러 처리 포함해서 로그인 함수 짜줘"가 낫다.

2-26. 모드 (작업 모드)

뜻: 클로드 코드가 일하는 세 가지 방식(일반 / 자동 수정 / 플래닝). 비유: 자동차 기어. 상황에 맞게 바꿔 넣는다. 예: 배우며 천천히는 일반, 빠른 반복은 자동 수정, 설계는 플래닝.

2-27. 헤드리스 모드 (Headless Mode)

뜻: 대화 화면 없이, 명령 한 줄로 작업만 실행하는 방식. 비유: 무인 자판기. 사람과 대화 없이 버튼 한 번에 결과만 나온다. 예: 스크립트나 자동화에서 클로드 코드를 한 줄로 호출한다.

3. 이 책의 척추 — 큰 그림

용어를 봤으니 이제 지도를 보자. 이 책은 왜 → 설정 → 기본조작 → 고급워크플로 → 실전제작 → 생태계도구 → 자동화 순으로 한 줄기로 이어진다.

비유로 보면 운전 배우기와 같다. 왜 이 차냐 → 차 사기 → 운전대 잡기 → 고급 주행 → 실제 도로 → 튜닝 부품 → 자동 주행.

이 큰 그림 하나만 기억하자. 앞 절반(1~14장)은 도구를 다루는 법, 뒤 절반(15~27장+부록)은 그 도구로 진짜 결과물을 만드는 법이다.

4. 이 책을 읽는 법 (입문판 사용 설명서)

규칙은 단순하다. 순서대로 읽되, 모르는 용어가 나오면 이 0장으로 돌아온다.

마지막으로 중요한 안내 하나. 이 책은 빠르게 변하는 도구를 다룬다. 요금, 모델 이름, 외부 도구의 버전 같은 숫자는 시간이 지나면 바뀐다. 책에 나오는 구체 수치는 원서/노트 기준 예시이며, 최신 값은 공식 문서(클로드 코드 공식 문서)에서 확인하면 된다. 그래서 이 입문판은 "변하지 않는 개념과 비유"를 중심으로 익히도록 만들었다.

다음 장 예고

다음 1장은 "왜 하필 클로드 코드인가"를 다룬다. 예전 AI 코딩이 답답했던 이유와, 클로드 코드가 그걸 어떻게 푸는지를 본다. 지금 그 내용을 몰라도 된다. 이 0장 용어집만 옆에 두면 충분하다.